home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / graphics / utils / copcoled_1.1 / copcoled.doc / copcoled.doc
Text File  |  1993-10-28  |  8KB  |  219 lines
  1. ·············································································
  2. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3. *****************************************************************************
  4.                       (---------------------------)
  5.                  THE  ( COPPER COLORS EDITOR V1.1 )  MANUAL
  6.                       (---------------------------)
  7. *****************************************************************************
  8. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  9. ·············································································
  10.  
  11.  
  12. RIGHTS: The manual and the program mustn't be changed by anyone who has
  13.         not the permission of the programmer.
  14.  
  15.         You may copy the COPCOL ED! If you use it,you should send 10DM or
  16.         $7 to:
  17.                                 Ludwig Huber
  18.                             Wilhelm-Busch-Weg 14
  19.                                86161 Augsburg
  20.                                   Germany
  21.  
  22.         If you want to distribute it in some way,contact me first.
  23.  
  24.  
  25. CHANGES FROM V1.0: -new "flicker" mode now built-in
  26.                    -when editing single lines,"UNDO" didn't work in some
  27.                     cases;not anymore
  28.                    -an error requester is now shown if not enough memory
  29.                     was available or the req.library couldn't be found
  30.                    -now you can save to the config a dir to load/save files
  31.                     from
  32.  
  33.  
  34. HOW TO RUN IT
  35. -------------
  36. To run CopCol Ed,you need to have the req.library in your LIBS: dir.
  37. You should find this library on the CopColEd-DISK.
  38. Req.library  was  written  by  Colin  Fox (of Pyramyd Designs) and
  39. Bruce  Dawson  (of  CygnusSoft  Software).Req.library is copyrighted.
  40.  
  41.  
  42. WHAT IS COPCOL ED?
  43. ------------------
  44. CopCol Ed is an editor for colors that can be displayed using the Amiga's
  45. COPPER.The program was made for PROGRAMMERS.
  46.  
  47.  
  48. THE SCREEN
  49. ----------
  50. On the left side,there are most of the gadgets of CopCol Ed,a zoom window
  51. of the selected Line and a display of numbers(S:Topline of right window;
  52. L:selected line;R,G,B:RED,GREEN,BLUE).On the right side of the screen,there
  53. is a window showing the colors as they will probably appear in you program.
  54.  
  55. THE GADGETS
  56. -----------
  57. You select a line in the right window by clicking on it.(use the right
  58. slider to move in the whole colorlist)
  59.  
  60. Use the sliders on the left side to change the color of the selected  Line.
  61.  
  62.  
  63. ABOUT - See this text
  64.  
  65. BINARY/SOURCE - Here you select the type of data to be saved.Data can be
  66.                 saved as binary-data or as Assembler source code.
  67.  
  68. ONLYCOLS/HARDWARE/OWNFTYPE - Here you select the type of data to be loaded
  69.                              or saved.
  70.           ONLYCOLS:always 24bit-color data(dc.b RED,GREEN,BLUE)
  71.           HARDWARE:the data you'll probably want to write to the color
  72.                    register (shape when 24bit-colors are selected:
  73.                       dc.w normal12bit,lower12bits_with_bits_as_usual)
  74.                             (shape when flickering is selected:
  75.     dc.w normal12bit_for_line_x_in_frame0,normal12bit_for_line_x_in_frame1)
  76.           OWNFTYPE:always binary-save;this is useful if you want to load a
  77.                    edited colorlist again(a load restores some settings)
  78.  
  79. LOAD - loads data(with defined type) into the colorlist
  80. SAVE - saves   "   "     "       "   from  "      " 
  81.  
  82. PREFS - LOAD CONFIG - loads the preferences
  83.         SAVE CONFIG - saves the preferences to "S:CopCol_ED.config"
  84.                       To save also a special directory to load/save files
  85.                       from,you have to load a file out of it and then save
  86.                       the config.
  87.  
  88.         NTSC/PAL - changes the screen size for pal/ntsc
  89.         24B-COLS/12B-COLS/FLICKER - Here you select the depth of the colors
  90.                                     to edit.
  91.                        To edit with 24BIT-COLS you need to have AA-CHIPSET.
  92.                     The flicker modus simulates colors with a depth of
  93.                     15bit.This is done by exchanging a color and a brighter
  94.                     color to simulate a color between the two displayed.
  95.                     The disadvantage here is that some colors flicker.I
  96.                     didn't build in a 24bit-flicker option because you
  97.                     wouldn't see a difference to a nonflicker AA-colorlist.
  98.  
  99.         AUTOSET - resets all settings
  100.         SIZE:XXXX - Here you can choose(use left&right mousebutton) the
  101.                     amount of lines to be edited and to be loaded(!).
  102.  
  103. CLRALL - sets all colors to black
  104. SPREAD - sets the colors of the selected line to the line you click after
  105.          the "SPREAD" gadget.You can abort this operation by clicking a
  106.          second time on "SPREAD".
  107. COPY - same as spread,but copies the selected line
  108. UNDO - if you think that your last change in the colorlist was wrong,click
  109.        here
  110.  
  111.  
  112. COPPER HARDWARE-PROGRAMMING EXAMPLES
  113. ------------------------------------
  114. - Part of a 12bit-color copperlist:
  115. dc.w $180,$fed  ;move RED:15 GREEN:14 BLUE:13 to color0
  116.  
  117. - Part of a 24bit-color(AA-chipset) copperlist:
  118. dc.w $180,$fed ;<-move RED:240 GREEN:224 BLUE:208 TO color0
  119. dc.w $106,$0200 ;set bit9 in bplcon3: now change lower colorbits
  120. dc.w $180,$123 ;<-move RED:241 GREEN:226 BLUE:211 to color0
  121. dc.w $106,$0000 ;clr bit9 in bplcon3: now change upper colorbits
  122.  
  123.     
  124. ***Two small Assembler-routines to test whether an Amiga has AA-chipset
  125. ***these two routines may be used&distributed in any way!
  126. ***INPUTS: NONE
  127. ***RESULT: d0.l=0 means no_aa_chipset_present
  128.  
  129. When you have to use hardware registers:
  130. -------------CUT HERE-------------
  131. testifaaispresent:
  132.     move.w $dff07c,d0
  133.     cmp.b #$f8,d0
  134.     bne.s noaachips
  135.     moveq #-1,d0
  136.     rts
  137. noaachips:
  138.     clr.l d0
  139.     rts
  140. -------------CUT HERE-------------
  141.  
  142. When you can use System-routines:
  143. -------------CUT HERE-------------
  144. SetChipRev=-888          ;only V39+
  145. GFXB_AA_ALICE=2
  146. gb_ChipRevBits0=$EC
  147.  
  148. testifaaispresent:    
  149.  
  150.     move.l $4,a6
  151.     lea aatst_graphname,a1
  152.     move.l #39,d0
  153.     jsr -552(A6)
  154.     tst.l d0
  155.     beq aatst_noV39
  156.     move.l d0,aatst_graphbase
  157.     
  158.     move.l aatst_graphbase,a6
  159.     move.l #-1,d0
  160.     jsr setchiprev(A6)    ;this is also done by c:setpatch of WB3.0
  161.         
  162.     move.l aatst_graphbase,a0
  163.     btst #gfxb_aa_alice,gb_chiprevbits0(a0)
  164.     beq aatst_notpresent
  165.     
  166.     move.l $4,a6
  167.     move.l aatst_graphbase,a1
  168.     jsr -414(a6)
  169.     
  170.     moveq.l #-1,d0
  171.     rts
  172. aatst_notpresent:
  173.  
  174.     move.l $4,a6
  175.     move.l aatst_graphbase,a1
  176.     jsr -414(a6)
  177.  
  178. aatst_noV39:
  179.     clr.l d0
  180.     rts
  181.  
  182. aatst_graphname:dc.b 'graphics.library',0
  183.     even
  184. aatst_graphbase:dc.l 0    
  185. -------------CUT HERE-------------
  186.  
  187.  
  188.  
  189. - When programming a flicker-copperlist,you must show different colors in
  190. each frame/screen/picture.You can either do this by setting the new colors
  191. from a vertical blanking interrupt,but so,processor/blitter time would be
  192. wasted.A better solution is to setup two copperlists in chipram (where
  193. the two lists contain different colors).Then,you just have to always set
  194. the address of the next copperlist to run to the copxlc-registers before
  195. ending the copperlists.In this way,there is practically not more time
  196. needed to display a flicker-colorlist than at a normal 12bit-colorlist.
  197. Don't forget how to read such a colorlist that was saved with COPCOLED:
  198. The 1st WORD for the even frames/pictures/screens,the 2nd WORD for the odd
  199. frames/pictures/screens,the 3rd WORD for the even....
  200.  
  201.  
  202.  
  203.  
  204. BUG REPORTS
  205. -----------
  206. If you find bugs in my program,report them to me and don't forget to tell
  207. me the conditions under which something happened(AXXXX,RAM?,68XXX).You can
  208. also write me if something worries you in my programs or if you have new
  209. ideas for improvements.
  210.  
  211.  
  212. ##############################################################################
  213. last changes in manual done on 15.8(AUGUST).1993
  214.  _         _   _
  215. ( )       ( )_( )
  216. ( )_   _  (  _  )  _   UUCP: midas@tomtec.abg.sub.org
  217. (___) (_) (_) (_) (_)
  218. The manual was written and COPCOL ED was programmed by Ludwig Huber.
  219. ##############################################################################